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Systeme et procSde de contrSIe d'Squipements a distance a Paide de 
fonctions API, dispositif et module de radiocommunication et jeu de 
fonctions correspondants. 

Le domaine de l'invention est celui du contrdle a distance d'equipements, 
et notamment d'equipements limits en ressources de traitement de donnees. 
Ainsi, l'invention s'applique par exemple aux systemes de releve de donnees a 
distance, par exemple sur des compteurs d'eau, de gaz ou d'61ectricite\ et plus 
generatement aux systemes de t616m*trie, de suivi de commandes, et plus 
generalement de contr61e de machines (en anglais « M to M : machine to 
machine »). 

II existe deja diverses solutions pour realiser de telles operations. Elles ont 
generalement ete developpees de facon specifique pour une application donnee. 
En d'autres termes, il s'agit de solutions « propri&aires », qui sont difficilement 
adaptables a d'autres applications. 

On connait par ailleurs un protocole, developp6 par les society IBM et 
ARCOM Control Systems (marques deposees), connu sous le nom de technologie 
« MQIsdp Messaging ». Cette technique propose un protocole de communication 
entre un ou plusieurs equipements limits en ressources, et un ou plusieurs 
serveurs (« brokers » en anglais), en utilisant un lien TCP/IP. 

Cependant, meme avec ce protocole specifique, il est necessaire 
d'adjoindre aux 6quipements des moyens de traitement specifiques 
(microprocesseurs, memoires, ...), qui permettent d'instaurer le dialogue avec ces 
serveurs distants, selon le format MQIsdp requis. La liaison entre l'equipement et 
le serveur peut utiliser une liaison de type t&ephonique, a l'aide d'un modem. 

Dans de nombreuses applications, il serait cependant souhaitable de 
pouvoir se passer d'une liaison telephonique filaire. On peut alors envisager la 
raise en ceuvre de moyens de radiocommunication, par exemple selon la norme 
GSM ou GPRS. 
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Dans ce cas, on utilisera un equipement de radiotelephonie pour assurer la 
fonction de modem. Cependant, il reste necessaire, selon Tart anterieur, d'associer 
a l'equipement des moyens specifiques et proprietaires de traitement de donnees 
pour etablir et realiser l'echange de donnees avec le serveur. 

Cet aspect est une limitation tres importante au developpement des 
applications mentionnees ci-dessus, et de nombreuses autres applications que 
permet d'envisager le protocole MQIsdp. 

L'invention a notamment pour objectif de pallier cet inconvenient de l'art 
anterieur. 

II convient de noter que le fait d'identifier ce probleme est en soi une 
partie de l'invention. En effet, l'homme du metier est persuade" qu'il est 
absolument necessaire d'equiper les equipements terminaux de moyens de 
traitement suffisants, et ne peut en aucun cas envisager qu'il est possible de les 
require, voire de les supprimer. 
15 c ' est Pourtant un objectif de l'invention que de permettre de simplifier les 

traitements necessaires du c6t<S des equipements, et d'eviter que ceux-ci doivent 
disposer de moyens complexes et couteux tels qu'un micro-processeur. 

Un autre objectif de l'invention est de proposer une technique simple et 
generique, permettant d'instaurer facilement et efficacement un dialogue avec un 
20 serveur selon le protocole MQIsdp. 

Ainsi, un objectif particulier de l'invention est de permettre d'assurer un 
tel dialogue de facon simple et peu couteuse, a l'aide d'un simple module de 
radiocommunication. 

Encore un autre objectif de l'invention est de fournir une telle technique, 
25 permettant d'etablir une liaison entre des serveurs et des equipements par voie 

radiotelephonique, de facon simple, standardised et peu coQteuse. 

L'invention a egalement pour objectif de fournir une telle technique, 
permettant de d6velopper un nombre important d'applications, sans qu'il soit 
necessaire de dgvelopper des applications specifiques a chaque fois. 

Un autre objectif de l'invention est de fournir une telle technique, ne 
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necessitant pas une connaissance du protocole MQIsdp dans les applications 
dEveloppEes. 

Encore un autre objectif de l'invention est de fournir une telle technique, 
qui est a la fois techniquement simple et Evolutive, et adaptable a diverses 
5 situations (par exemple pour la taille des donnees a echanger) et aux eventuelles 

Evolutions futures. 

Ces objectifs, ainsi que d'autres qui apparaitront plus clairement par la 
suite, sont atteints selon l'invention a l'aide d'un systeme de contrdle 
d'equipements a distance, permettant 1' interconnexion entre au moins un serveur 
10 et au moins un equipement distant selon le protocole MQIsdp. 

Selon l'invention, le systeme de controle associe a au moins un desdits 
equipements distants des moyens de radiocommunication capable de traiter en 
interne un protocole de communication mettant en oeuvre des fonctions source de 
type API disponibles dans une plateforme logicielle (Open AT) permettant 
15 d'embarquer au moins une application, et lesdits moyens de radiocommunication 

sont dotEs d'un jeu de fonctions (API) spEcifiques permettant d'echanger des 
donnees avec au moins un serveur mettant en oeuvre ledit protocole MQIsdp, de 
faeon a permettre une interconnexion entre le ou lesdits serveurs et le ou lesdits 
Equipements distants via lesdits moyens de radiocommunication, ces derniers 
20 gerant Egalement au moins une application entre le ou lesdits serveurs et le ou 

lesdits Equipements distants. 

Ainsi, il est possible de gerer entierement en interne, dans les moyens de 
radiocommunication, et en particulier dans un module, l'application de contrdle 
d'un ou plusieurs terminaux avec un serveur fonctionnant selon le protocole 
25 MQIsdp, sans que le terminal ne connaisse ce protocole. II n'y a rien a rajouter, du 

c6tE du terminal (ni materiel, tel que microprocesseur ou memoire, ni logiciel, tel 
qu'une application dediee). C'est le module qui gere ces operations, a l'aide des 
fonctions de l'invention, et assure 1'interface avec le protocole MQIsdp. 

Selon un mode de realisation avantageux, lesdits moyens de 
30 radiocommunication comprennent un module de radiocommunication, regroupant 



WO 2004/114624 

PCT/FR2004/001498 



sur un m6me substrat l'ensemble des moyens de traitement de donnees radio- 
frequence et bande de base, ainsi que les moyens de gestion desdites fonctions 
(API) et la ou lesdites applications. C'est ce module qui integre Implication et les 
fonctions source (API). 

5 De facon preTerentielle, lesdits moyens de radiocommunication integrent 

ledit protocole MQIsdp sous la forme d'une librairie, deimissant ledit jeu de 
fonctions (API) specifiques. 

Au moins dans un premier mode de mise en oeuvre, lesdits moyens de 
radiocommunication gerent uniquement la signatisation d'un Schange de donnees, 
10 lesdites donnSes etant transferees directement d'un equipement distant vers un 

serveur, ou inversement. 

Dans un second mode de mise en oeuvre avantageux, qui est celui 
actuellement d6veloppe\ lesdits moyens de radiocommunication gerent la 
signalisation d'un echange de donnees et le transfert desdites donnees, ces 
15 dernieres &ant temporairement stockees dans au moins une memoire tampon. 

Dans ce cas, la taille de la ou desdites mSmoires tampon est 
avantageusement parametrable. 

Si les deux modes de realisation sont disponibles, on prevoit 
avantageusement que l'on fonctionne dans ledit premier mode lorsque la taille de 
20 la ou desdites m6moires tampon vaut 0, et dans ledit second mode sinon. 

De facon avantageuse, ledit jeu de fonctions API specifiques comprend 
des fonctions permettant : 

- la connexion a un desdits serveurs ; 

- l'envoi de messages ; 

25 - la reception de messages ; 

- configuration d'au moins un parametre. 
PreTerentiellement, au moins certaines desdites fonctions (API) specifiques 

sont organises de facon a pouvoir assurer au moins deux operations et/ou agir sur 
au moins deux aspects distincts, en fonction d'un param&rage pr€d6fini. 

Cela permet d'optimiser le nombre de fonctions, tout en rendant possible 
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des evolutions. 

Dans un mode de realisation pr6ferentiel, ledit jeu de fonctions (API) 
comprend uniquement 12 fonctions. 

De fagon avantageuse, ledit jeu de fonctions (API) sp6cifiques comprend 
une fonction d'initialisation (mqisdp_init) rdtablissant des parametres par deiaut, 
et devant Stre appelee au moins une fois avant l'utilisation d'autres fonctions 
(API). 

PreTerentiellement, ledit jeu de fonctions (API) specifiques comprend une 
fonction (mqisdp_resume) appelee lorsque une liaison IP a 6t6 6tablie. 

Avantageusement, il comprend une fonction d'6tablissement d'une 
connexion avec un desdits serveurs (mqisdp_connect), permettant de deTinir des 
parametres de ladite connexion, et une fonction de deconnexion 
(mqisdp_disconnect) de ladite connexion. 

Ladite fonction d'gtablissement d'une connexion permet notamment, 
avantageusement, de selectionner un mode de transmission parmi au moins deux 
(GSM et GPRS). 

Ledit jeu de fonctions comprend encore, avantageusement, une fonction 
(mqisdp_publish) pour l'envoi d'un message vers un desdits serveurs. 

PreTerentiellement, il comprend une fonction d'abonnement a un desdits 
serveurs (mqisdp.subscribe), et une fonction de desabonnement 
(mqisdp_unsubscribe) audit serveur. 

De fa?on avantageuse, ledit jeu de fonctions comprend au moins une 
fonction de demande d'information sur au moins un aspect d'une communication 
en cours, et par exemple au moins une des fonctions appartenant au groupe 
comprenant : 

- une fonction de demande du statut d'une connexion 
(mqisdp_getConStatus) ; 

- une fonction de demande du statut d'un message donn6 
(mqisdp_getMsgStatus) ; 

- une fonction de demande de la taille actuelle d'une file d'attente 
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(mqisdp_getQueueSize) ; 
- une fonction de demande de l'espace disponible dans une file 
d'attente (mqisdp_getAvailableSize). 
Pr6ferentiellement, il comprend une fonction de definition de la taille 
5 d'une file d'attente (mqisdp_setQueueSize). 

L'invention conceme egalement les proc6des de contrdle d'equipements a 
distance, permettant ^interconnexion entre au moins un serveur et au moins un 
equipement distant selon le protocole MQIsdp. 

Un tel procSde associe a au moins un desdits equipements distants des 
10 moyens de radiocommunication capable de trailer en interne un protocole de 

communication mettant en oeuvre des fonctions source de type API disponibles 
dans une plateforme logicielle (Open AT) permettant d'embarquer au moins une 
application, et met en ceuvre, dans lesdits moyens de radiocommunication, un jeu 
de fonctions API specifiques permettant d'echanger des donn6es avec au moins 
15 un serveur mettant en oeuvre ledit protocole MQIsdp, de facon a permettre une 

interconnexion entre le ou lesdits serveurs et le ou lesdits equipements distants via 
lesdits moyens de radiocommunication, ces derniers g6rant egalement au moins 
une application entre le ou lesdits serveurs et le ou lesdits equipements distants. 

L'invention concerne encore les dispositifs et les modules de 
20 radiocommunication mis en oeuvre dans un systeme de contrdle d'equipements a 

distance stel que d6crit ci-dessus. 

L'invention concerne enfin egalement un jeu de fonctions (API) mis en 
oeuvre dans un systeme de contrdle d'equipements a distance, permettant 
d'echanger des donnees avec au moins un serveur mettant en oeuvre ledit 
25 protocole MQIsdp. 

D'autres caracteristiques et avantages de l'invention apparattront plus 
clairement a la lecture de la description suivante d'un mode de realisation 
prtferentiel de l'invention, donn<5 a titre de simple exemple illustratif et non 
limitatif, et des dessins annexes, parmi lesquels : 
30 ~ la fi S ure 1 iHustre un exemple de systeme dans lequel l'invention peut 
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Stre mise en ceuvre ; 

- la figure 2 est un exemple d'integration du protocole MQIsdp dans un 
module selon l'invention ; 

- la figure 3 est un synoptique simplify d'un exemple d'envoi de 
message mettant en oeuvre l'invention. 

1, Rappels sur le protocol MQIsdp rmarque dep osfr>) 

Le protocole MQIsdp (« WebSphere MQ Integrator SCADA device 
protocol » en anglais) est une norme ouverte developp6e par IBM et Arcom 
Control Systems (marques deposees), visant a permettre les echanges de donn6es 
(sous forme de messages) depuis des dispositifs distants (ou terminaux), 
gendralement de bas de gamme et disposant de peu de puissance de traitement, 
vers un serveur, appele egalement par la suite « courtier » (« broker » en anglais) 
WebSphere MQ Integrator par TCP/IP, et inversement. 

MQIsdp (egalement appele" par la suite Wavecom SCADA) est un 
protocole de transfert de donnees (message) bas6 sur un modele de 
communication du type publier/souscrire, disponible libre de droit sur Internet. II 
peut 8tre decrit comme une simple couche de gestion de donnees agnostiques 
au-dessus du protocole TCP/IP pour assurer la gestion et les accuses de reception 
de message requis afin d'assurer la livraison fiable du message. 

Dans le modele de communication publier/souscrire, les donnees sont 
echangees entre un producteur/consommateur de donnees (le client) et un courtier 
de message (le serveur). Le courtier de messages peut Stre consid6re" comme un 
« hub » (nceud) de commutation multiprotocole au niveau du protocole de 
Implication qui recoit des messages, les transforme, les reformate, etc. en d'autres 
structures en fonction d'un modele de donnees defini par l'utilisateur. 

Enfin, les messages eventuellement transformed peuvent gtre envoyes par 
le courtier (publies) aux clients (dispositif de zone, ERP, SAP, Oracle, SQL, etc.) 
abonnes en utilisant les cartes clients appropriees. Le courtier peut, evidemment, 
publier 6galement des messages ne provenant pas d'un client. 

Le courtier de messages gere tous les messages entrant et sortant d'une 
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rubrique. Un client publie des messages dans/avec une rubrique ou souscrit a des 
messages de/par une rubrique identifiant le flux de message du courtier de 
message vers lequel ou a partir duquel le message doit Stre public. 

La sp6cification MQIsdp definit un ensemble de messages tres simple, 
comprenant: « connect » (connecter), « disconnect » (de-connecter), « publish » 
(publier), « subscribe » (abonner), « unsubscribe » (desabonner). 

2. principes de rinventinn 

2.1 %4n£ralitp.s 

L' invention concerne done une nouvelle approche du contrdle 
d'equipements a distance, reposant notamment sur la mise en ceuvre d'un jeu de 
fonctions specifiques API permettant a une application externe de gerer des 
echanges de donn6es entre un terminal distant et un serveur, via des moyens de 
radiocommunication (par exemple un module de type Wismo (marque deposee)), 
sans que l'application connaisse le protocole MQIsdp mis en ceuvre par le serveur. 
Ce sont les moyens de radiocommunication qui gerent cet aspect, et par exemple 
les acquittements pr6vus dans le protocole MQIsdp. 

Les fonctions API sont des fonctions developpees en langage C, qui 
permettent au module de g6rer en interne, sous le contrdle d'une application elle- 
m8me interne au module, des echanges de donnees avec des serveurs mettant en 
20 oeuvre le protocole MQIsdp. 

La figure 1 illustre de facon simplified le principe de V invention. 
L'objectif est de faire communiquer tout type de machines distantes, par exemples 
des instruments de mesure 11 avec une ou plusieurs applications hebergees par 
des serveurs 12, capables de recevoir des donnees 13 selon le protocole MQIsdp, 
25 et de les transformer, traiter ou transmettre. 

Selon 1'invention, on associe aux terminaux (ou machines) distants 11 des 
moyens de radiocommunication 14, par exemple sous la forme d'un module 
Wismo (marque deposee), embarquant notamment les outils de developpement 
distribue's par le deposant sous la marque « Muse platform ». 
30 2.2 Notion de module 
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Pour memoire, on rappelle que la plupart des dispositifs de 
radiocommunication comprennent, de facon classique, un ensemble de 
composants electroniques implants sur un circuit imprime. Ces diffSrents 
composants ont pour but d'assurer les diffSrentes fonctions necessaires, depuis la 
reception d'un signal RFjusqu'a la gyration d'un signal audible (dans le cas d'un 
radio-telephone), et inversement. Certaines de ces fonctions sont analogiques, et 
d'autres numeriques. 

La fabrication de ces dispositifs de radiocommunication est un sujet de 
recherche important. En effet, on vise au moins trois objectifs difficiles a 
concilier : miniaturiser les dispositifs, augmenter les fonctionnalites et simplifier 
le montage. On sait notamment que l'implantation des differents composants sur le 
circuit imprime est une operation relativement complexe, de nombreux 
composants devant etre mis en place sur une surface de plus en plus restreinte, du 
fait des exigences de miniaturisation. 

La conception de ces systemes est done complexe, puisqu'elle necessite en 
outre d'associer des composants divers, souvent de sources multiples, qu'il faut 
faire fonctionner ensemble, en respectant les specificites de chacun. Par ailleurs, 
apres le montage de l'ensemble des composants, des phases de calibration et de 
tests, souvent longues et complexes, sont necessaires pour garantir le bon 
fonctionnement du dispositif. 

Enfin, malgre la reduction de la taille de certains composants, l'ensemble 
occupe une certaine surface, qu'il est difficile de require. 

Le titulaire de la presente demande de brevet a propose une approche 
palliant un certain nombre de ces inconvenients, consistant k regrouper dans un 
module unique, toutes ou au moins la plupart, des fonctions d'un dispositif de 
radiocommunication numenque. 

Un tel module se presente sous la forme d'un boitier unique et compact, 
preferentiellement blinde, que les fabricants de dispositifs peuvent implanter 
directement, sans devoir prendre en compte une multitude de composants. 
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Ce module (encore appeie parfois « macro-composant ») est en effet forme 
d'un regroupement de plusieurs composants sur un substrat, de facon a Stre 
implant sous la forme d'un unique element. II comprend les composants et les 
logiciels essentiels necessaires au fonctionnement d'un terminal de 
5 telecommunication utilisant des frequences radio-electriques. II n'y a done plus 

d'etapes complexes de conception du design, et de validation de celui-ci. II suffit 
de reserver la place necessaire au module. 

Un tel module permet done d'integrer facilement, rapidement et de facon 
optimisee l'ensemble des composants dans des terminaux sans-fil (telephones 
10 portables, modems, ou tout autre application exploitant un standard sans fil). 

Par ailleurs, celui-ci regroupant toutes les fonctions essentielles et ayant 
6t6 concues comme un tout, les problemes de calibration et de tests ne se posent 
plus de la meme maniere, ou sont a tout le moins, grandement simplifies. 

Ainsi, les modules diffuses par le titulaire de la prSsente demande de 
15 brevet sont entierement testes tant sur le plan materiel (« hardware ») que logiciel 

(« software ») sur la plupart des rdseaux sur lesquels ils pourront etre utilises 
ensuite. En outre, le module englobe avantageusement les aspects de propriete 
industrielle (toutes les fonctions ayant 6t6 regroupees, e'est le fabricant du module 
qui gere les aspects de droits de propriety industrielle correspondants) et 
20 d'assistance technique. 

2.3 fonctions API 

On connait deja des modules embarquant des fonctions API. Le document 
de brevet FR-0103909, pnSsente ainsi un module de radiocommunication, du type 
hebergeant et executant un logiciel principal assurant notamment des fonctions de 
25 radiocommunication, ledit logiciel principal comprenant des moyens d'execution 

de commandes de pilotage, envoyees au logiciel principal par au moins un logiciel 
client de pilotage et appartenant a un jeu de commandes de pilotage predetermine. 

Selon cette technique, le module de radiocommunication biberge et execute 
en outre au moins un logiciel client, dit logiciel client embarque. En outre, le 
30 logiciel client embarque et le logiciel principal comprennent des moyens 
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permettant au logiciel client embarqug de jouer au moins un des deux r61es 
suivants : 

le rdle d'un logiciel client de pilotage, envoyant des commandes de 
pilotage au logiciel principal, et recevant du logiciel principal des 
reponses, resultant de l'execution de certaines des commandes de 
pilotage ; 

le rdle d'un logiciel client de supervision, gerant l'execution de 
commandes de pilotage envoyees par un logiciel client de pilotage, 
dit logiciel client externe, hSberge et execute par un equipement tiers 
cooperant avec le module de radiocommunication. 
Le principe general de l'invention consiste done a h6berger sur le 
module de radiocommunication au moins un logiciel client pouvant jouer le 
r61e d'un logiciel client de pilotage et/ou le rdle d'un logiciel client de 
supervision. 

On pourra se referer a ce document pour plus de d6tails, si 

necessaire. 

2.4 Nouvellc s fonctinnv API 

Le module 14 est done capable, selon l'invention, de gerer des fonctions 
API, et en nombre reduit, permettant un dialogue simple et efficace avec un 
terminal, sous le contrdle d'une application interne. II assure la transformation au 
format MQIsdp, et gere remission et la reception de donnees 15 selon ce 
protocole, de faeon transparente pour l'application et le terminal. 

L'echange de donnees peut ainsi se faire de faeon hertzienne 16, par 
exemple selon le standard GSM ou GPRS. Vu du serveur 12, les informations 
sont au format MQIsdp. Pour les terminaux 11, il n'est pas necessaire de connaitre 
ce protocole, ni de mettre en ceuvre des moyens particuliers, tels qu'un 
microprocesseur et des memoires, et une application d6diee. 

Comme on le verra par la suite, les fonctions proposees peuvent etre en 
nombre limits, tout en permettant des evolutions. 

Les donnees transitent par le module 14. Elles sont alors stockees 
temporairement dans des buffers (memoires tampon), dont la taille est 
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configurable en fonction des besoins. 

La figure 2 illustre un exemple simplifig d' architecture logicielle pouvant 
6tre mise en oeuvre dans le module 14. 

Un tel module 14 comprend generalement : 
5 - une couche logicielle de base 21 (« Wavecom Core Software ») ; 

- une bibliotheque Open AT 22 (« Open AT Library ») ; 

- une bibliotheque ADL 23 (« ADL Library ») ; 

- une bibliotheque TCP/IP 24 (« TCP/IP Library ») ; 

- une couche applicative 25 (« Open AT Application »). 

10 Selon 1'invention, on prevoit done en outre une bibliotheque 26 de 

commandes specifiques (« Wavecom SCADA Protocol Library ») pour 
communiquer selon le protocole MQIsdp, qui se place au dessus de la 
bibliotheque TCP/IP 24. 

L'interface proposee comprend, dans cette bibliotheque 26, seulement 12 
15 fonctions API, permettant d'exploiter entierement le protocole MQIsdp. Ces 

fonctions sont detaillees par la suite. 

Optionnellement, les commandes AT 27 s'adressent, selon les cas, a la 
couche de base 21, a la bibliotheque TCP/IP 24 ou a la bibliotheque SCADA 26. 
Le module peut en effetegalement gerer des commandes AT, pour assurer les 
20 m6mes operations d' interface. 

3, description d&aiUee d'u n mode de r ea lisa tion de fonctions APT 

On decrit ci-apres les fonctions API pouvant Stre utilisees pour piloter le 
protocole Wavecom SCADA 26. 

3J. Documents connexea 

25 En cas de besoin, on pourra se rdferer a : 

[1] la fiche "WepSphere MQ Integrator SCADA Device Protocol" figurant 
a l'annexe B du manuel de reference "IBM WebSphere MQ Integrator 
Programming Guide" disponible a l'adresse suivante : 
http://publifp.boulder.ibm.com/epubs/odf/bipval04.pdf 
30 [2] Wavecom AT Commands Interface Guide 
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Reference : WM_SW_OAT_IFS_001 - revision : 009 ou suivantes. 

Ce document decrit les commandes AT prises en charge par le 
produit Wavecom permettant de gerer les evenements ou services GSM 
connexes. 
[3] AT Command Interface for TCP/IP 
Revision : 1.7 

Ce document decrit les parametres et le jeu de commandes AT 
permettant la configuration et le pilotage de la superposition TCP/IP et 
des protocoles disponibles sur les produits Wavecom. 
[4] WebSphere MQ Integrator Programming Guide (Version 2.1), Annexe 
B. 

[5] Edjlb-30x Interface Specification 

[6] ADL User Guide 

12 Abrtviation s et de finitions 

3.2.1. Abriviations 

MQIsdp Protocole de dispositif MQ Integrator SCADA 
SCADA Supervisory Control and Data Acquisition (Dispositif de 

surveillance et acquisition des donnees) 
APN Access Point Name (Norn de point d'acces) 

AT Attention 

DNS Domain Name Systeme (Systeme de noms de domaine) 

ISP Internet Service Provider (Fournisseur de services sur Internet) 

ME Mobile Equipment (Materiel mobile) 

MS Mobile station (Station mobile) 

QoS Quality of Service (Qualite" de service) 

2J. architecture 

La bibliotheque MQIsdp est construite au-dessus de la bibliotheque ADL 
de Wavecom et de la bibliotheque TCP/IP. Des applications imbriquees utilisant 
la bibliotheque MQIsdp doivent done etre mises en ceuvre a l'aide de la 
bibliotheque ADL (plut6t qu'avec la couche API Open AT standard directement). 
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15 



La figure 2 deja commence presente cette architecture. 
Le logiciel « MQIsdp for Open AT » selon ce mode de realisation contient 
les Elements suivants : 

• Une bibliotheque logicielle conforme a ADL (wmmqisdp.lib) 
5 • Un fichier d'en-tgte (mqisdp.h) deTmissant l'API MQIsdp 

• Quelques echantillons de code source 

Une application imbriquee utilisant la bibliotheque MQIsdp doit etre reliee a 
wmadi.lib et edlib.lib (ces bibliotheques sont incluses dans le logiciel « MQIsdp 
for Open AT » fourni avec le module). 

10 £d Remaraues relatives h 1. a gesjiog d e mSmnire 

En raison des ressources de memoire limitees dans l'environnement Open 
AT, il est important de connattre exactement la quantity de m6moire utilisee par 
une bibliotheque ou un processus donne\ La bibliotheque MQIsdp est done 
centnSe sur une gestion precise de la m6moire. 

Toutes les fonctions de commande MQIsdp dans l'application API 
(connect (connecter), publish (publier), subscribe (abonner), unsubscribe 
(d<Ssabonner) et disconnect (deconnecter)) sont asynchrones (les fonctions 
renvoient imm€diatement et la sortie finale des operations associees est signalee 
par rappel). 

II peut exister a tout moment des messages MQIsdp que la bibliotheque a 
accept, mais qui n'ont pas 6t6 envoySs au courtier, qui n'ont pas encore recu 
d'accusds de reception de la part du courtier ou qui n'ont pas encore 6t6 distribu^s 
a l'application imbriqu6e Oe client). Tous ces messages en suspens sont conserves 
dans la file d'attente par la bibliotheque. La bibliotheque ne peut pas garantir la 
taille maximale de cette file d'attente car elle depend de la taille des donnees a 
envoyer/recevoir, de la frequence d'envoi/r^ception et de la largeur de bande de la 
connexion TCP/IP. 

Un contrdle complet de la taille maximale de la file d'attente est fourni a 
Implication client par un ensemble de fonctions API permettant de deTinir et de 
30 connaltre la taille maximale de la file d'attente et de demander la taille actuelle de 
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la file d'attente. 

Dans certains cas (taux Sieve" d'erreurs de transmission entralnant des 
coupures frequentes de la connexion), une taille plus elevee de la file d'attente est 
necessaire car la bibliotheque doit mettre les messages en memoire tampon 
jusqu'a ce que la communication soit rStablie. 

3.5 remarques comp U.mentnirP.fi 

3.5.1 Une seule connexion MQIsdp a lafois 

La bibliotheque MQIsdp depend de la bibliotheque TCP/IP, qui est limitee 
a une connexion a la fois. La bibliotheque MQIsdp est done limitee a une seule 
connexion MQIsdp a la fois. 

3.5.2 Taille de message MQIsdp limine 

La bibliotheque peut 6tre concue pour envoyer et recevoir des messages 
MQIsdp avec une taille maximale de 65 535 octets (y compris des en-tetes fixes et 
variables). 

La specification MQIsdp autorise des longueurs de charge utile maximales 
de 268 435 455 octets, ce qui signifie qu'un courtier peut potentiellement envoyer 
un message supeneur a 65 535 octets (ou la taille limite de la file d'attente) au 
client. Dans ce cas, le client est prevenu par un programme de traitement que la 
file d'attente est saturee (et le message n'est pas recu). De meme, si le client essaie 
d'envoyer des messages alors que la file d'attente est saturee, une indication 
signale que la file d'attente est saturee et que l'envoi du message n'a pas €t€ 
accept6. 

II est ainsi aisS de gerer la saturation eventuelle d'une file d'attente et/oii la 
transmission d'un message de taille trop importante. 

Comme deja mentionnS, on peut egalement, dans certains modes de 
realisation, prevoir des transferts directs entre un terminal et le serveur, le module 
ne gerant que la signalisation. 

3.6 API MQIsdp 

Les sections suivantes donnent une description d6taillee de toutes les 
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fonctions de l'API MQIsdp. 

3.6.1 En-tSte regj&£ 

L'en-t€te des fonctions MQIsdp est : Mqisdp.h 

3.6.2 Fonction mqixdp init 

5 Cette fonction DOIT Stre appelee pour initialiser la bibliotheque MQIsdp ; 

elle doit 8tre appelee au moins une fois avant l'utilisation des autres fonctions API. 

La fonction retablit (ou reinitialise) les valeurs par deTaut des parametres 
de connexion et des options de connexion. Elle regie la taille de la file d'attente 
sur 3 Ko. Si la fonction est appelee lorsqu'une connexion est active, elle 
10 deconnecte brutalement et supprime tous les messages en file d'attente. 

La bibliotheque TCP/IP DOIT Stre initialised avant l'initialisation de la 
bibliotheque MQIsdp. 

a - Prototype 

u8 mqisdp_init (mqisdp_linkHdlr_f LinkHandler) ; 
15 b - Parametres 

* LinkHandler : 

Le parametre LinkHandler est appele par la bibliotheque lorsqu'une liaison 
IP est necessaire mais absente ou lorsque la liaison IP est presente mais pas 
necessaire. II permet done a l'application client de contrdler precisement la liaison 
20 IP. 

Le type suivant est utilise* pour le parametre LinkHandler : 

typedef void (*mqisdpJinkHdlr_f)(u8 Event) ; 
Le parametre Event peut 6tre : 

- MQISDP_LINK_NEEDED si une liaison IP est necessaire, mais 
25 qu'aucune liaison n'est 6tablie. 

- MQISDP_LINK_CLOSABLE si une liaison IP n'est plus 
necessaire mais qu'une liaison est encore 6tablie. 

L'appelant peut soit fournir un parametre LinkHandler conforme au 
prototype ci-dessous, soit utiliser NULL. Si le parametre LinkHandler est NULL, 
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la bibliotheque assurera le contrdle de la liaison IP et essaiera de (re)6tablir une 
liaison IP lorsqu'l est necessaire et de fermer la liaison lorsqu'elle n'est plus 
necessaire. Dan ce cas, la composition, les parametres PPP et/ou CPRS doivent 
avoir et<5 actives par I'API TCP/IP avant la connexion a un courtier de message, 
c - Valeurs de rejQur 

MQISDP_OK : L'initialisation (ou la reinitialisation) a abouti. 

3.6.3 - Fon ction mq i sdp resume 

Cette fonction doit etre appelee lorsqu'une liaison IP a 6t6 etablie apres que 
la bibliotheque MQIsdp a indiquS qu'une liaison IP 6tait necessaire 
(MQISDP_LINK_NEEDED) par l'intermddiaire du programme de traitement de 
liaison. 

a - Prototype 

void mqisdp_resume () ; 
b - Parametres 
Aucun. 

c - Valeurs de retonr 
Aucune. 

3.6.4 - Fon ction mqisdp connect 

Cette fonction est utilisee pour €tablir une connexion avec un courtier de 
message. La fonction est asynchrone et le resultat final de l'operation est signale 
par une fonction de rappel (ConCtrlHandler). Si une connexion est deja active 
lorsque cette fonction est appelee, une erreur est renvoyee. 

a - Prototype 

u8 mqisdp_connect ( 
mqisdp_connectionParams_t * ConnectionParams , 
mqisdp_connectionOptions_t Connect ionOpt ions, 
mqisdp_connectionWill_t ConnectionWill, 
mqisdp_conCtrlHdlr_f ConCtrlHandler, 
mqisdp_msgCtrlHdlr_f MsgCtrlHandler, 
mqisdp_subCtrlHdlr_f SubCtrlHandler , 
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mqisdp_msgHdlr_f MsgHandler, 
) ; 

b - Parametres 

* ConnectionParams : Pointeur vers une structure contenant les 
informations de connexion de base. Le pointeur ne doit PAS Stre avoir une valeur 
nulle ; la structure utilise le type suivant : 

typedef struct 
{ 

// Client id with a maximum length of 29 
ascii*Clientid; 

//Address of message broker (ip or name, according to the settings of the 

TCP/IP stack) 

ascii*BrokerAddress; 

} 

mqisdp_connectionParams_t; 

* ConnectionOptions : 

Pointeur vers une structure contenant les informations de connexion 
facultatives utilisant le type suivant : 
typedef struct 
{ 

//Port on which to connect to the message broker 
ul6 Port;//default : 1883 

//Keep Alive Timer; C=no keep-alive messages 
ul6 KeepAliveTimer; // default :0 

//Retry count; how many times a connection attempt or message sending 

should be retried 

ul6 RetryCount://default : 10 

//Retry delay : how long the library should at least wait before retrying (in 
seconds) 
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ul6 RetrayDelay;//default : 10 

//Clean flag : indicates whether each a client connection should be 
performed or not! 

bool nCleanConnection://default : TRUE 
} 

mqisdp_connectionOptionsJ:; 

Le pointeur peut avoir la valeur nulle (NULL). Dans ce cas, les valeurs par 
defaut sont utilisees. 

* ConnectionWill : 

Pointeur vers une structure contenant les informations sur le will de 
connexion. La structure utilise le type suivant : 
typedef struct 
{ 

//Quality of service 

u8 Qos; 

bool Retain; 

ascii* Topic; 

ul8 PayloadLength; 

u8 Payload [3]; 

} 

mqisdp_connectionwill_j; 

Le pointeur peut avoir la valeur nulle (NULL). Dans ce cas les valeurs par 
defaut sont utilisees. 

* ConCtrlHandler : 

Programme de traitement de controle de connexion par lequel le client re?oit 
des 6venements relatifs a la connexion. Le programme de traitement utilise le type 
suivant : 

typedef void (*mqisdp_conCtrlHdlr_f) (u8 Event, u8 ErrorCode); 
Le param&tre Event peut avoir les valeurs suivantes : 
MQISDP_CON_OPEN : La connexion au courtier est pr6te. 
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MQISDP_CON_ERR : La connexion n'a pas pu 6tre etablie en raison 

d*une erreur ou s'est interrompue (la 
bibliotheque peut tenter de la retablir). 

MQISDP_CON_ACCEPTED : La connexion mqisdp avec le courtier 
5 est prete. 

MQISDP_CON_REFUSED : La connexion mqisdp avec le courtier a ete 

refusee. 

MQISDP_CON_IN_Q_FULL : Des donnees entrantes ont 6t6 

refusees car la file d'attente est saturee. 
10 MQISDP_CON_BROKEN : La connexion mqisdp avec le courtier s'est 

interrompue et toutes les tentatives de 
reconnexion ont 6chou6. 

MQISDP_CON_CLOSED : La connexion avec le courtier a ete fermee 

(proprement). 

15 MQISDP_CON_DISCONNECTED : La connexion mqisdp avec le courtier 

a 6t6 fermee (proprement). 
Dans un scenario normal (depuis la connexion jusqu'a la deconnexion), le 
programme de traitementde controle recoit la sequence suivante d'evenements : 
MQISDP_CON_OPEN 
20 MQISDP_CON .ACCEPTED 
MQISDP_CON_CLOSED 
MQISDP_CON_DISCONNECTED 

L'envoi de messages n'est possible que lorsque la connexion MQIsdp est 
prete (c'est-a-dire lorsque la fonction MQISDP_CON_ACCEPTED a 6t6 reeue et 
25 qu'aucune deconnexion n'a eu lieu ou n'a 6t6 effectuee. 

Le parametre Errorcode n'est utilise que si le parametre Event est 
MQISDP_CON_REFUSED. Dans ce cas, le code d'erreur peut prendre les formes 
suivantes : 

MQISDP_ERR_PROTOCOL_VERSION_ERROR : Connexion refusee en 

raison d'une version de protocole non prise 
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en charge. 

MQISDP_ERR_INDENTIFIER_REJECTED : Connexion refus^e en 

raison d'un rejet de l'identificateur. 

MQISDP_ERR_BROKER_UNAVAILABLE : Connexion refusSe en 
5 raison de Tindisponibilitg du courtier. 

MQISDPJTCPIPJJNAVAILABLE : La connexion n f a pas pu Stre 6tablie 

en raison d'une erreur sur la liaison TCP/IP. 

MQISDPJDNS ..PROBLEM : La connexion n'a pas pu dtre Stablie en raison 

d ! une erreur SND. 

10 MQISDP_ERR_SOCKET_ERROR : La connexion n'a pas pu etre 6tablie 

en raison d f une erreur de socket 

* MsgCtrlHandler : 

Programme de traitement de controle des messages par lequel le client 
re?oit des evenements relatifs a l'envoi du message. Le programme de traitement 
15 utilise le type suivant : 

typedef void (*mqisdp_msgCtrlHdlrjF) (u8 Event, ul6 Msgid); 
Le parametre Event peut prendre les formes suivantes : 
MQISDP_MSG_DELIVERED : Le message a 6t6 envoye/distribue 

(conformSment au param&tre Qos). 
20 MQISDP_MSG_DISCARDED : Le message a et<* supprime (Schec de 

toutes les tentatives). 
Le param&tre Msgid contient Tid du message concerne par l'ev&iement. 
L f id d f un message est renvoyg lors de l'utilisation de Tune des fonctions suivantes : 
mqisdp_publish, mqisdp_subscribe, mqisdp_unsubscribe, mqisdp_disconnect. 
25 * SubCtrlHandler : 

Programme de traitement de contrdle d f abonnement par lequel (s'il n'a pas 
la valeur nulle (NULL)), le client regoit des 6v£nements relatifs k l'accuse de 
reception de l'abonnement. Si le programme de traitement a la valeur NULL, les 
6v6nements d'accus6 de reception de l'abonnement sont transfers au programme 
30 de traitement de controle des messages. 
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En revanche, les informations relatives au niveau accord^ de qualite de 
service pour chacune des rubriques souscrites ne peuvent pas etre re§ues par 
l f interm€diaire du programme de traitement de controle des messages. 

Le programme de traitement de controle d'abonnement utilise le type 
suivant : 

typedef void (*mqisdp_subCtrlHdlr_f) ( 
u8 Event, 

mqisdp_subscriptionParams_t* SubscriptionAray 

); 

Le paramfctre Event peut prendre les formes suivantes : 

MQISDPJV1SGJDELIVERED : Le message a ete envoye/distribue 

(conformSment au param£tre Qos). 

MQISDP_MSG_DISCARDED : Le message a ete supprime (<5chec de 

toutes les tentatives). 

Le parametre Msgid contient l'id du message concerne par l'ev&iement. L ! id 
du message est renvoye lors de Tutilisation de la fonction mqisdp_subscribe. 

Le parametre SubscriptionArray est un tableau d'elements de la structure 
suivante : 

Typedef struct 

{ 

ascii* Topic, 
u8 QoS 
} 

mqisdp_subscriptionParams_t; 

Le tableau conserve des informations sur le niveau accorde de quality de 
service pour chacune des rubriques souscrites. 
* MsgHandler : 

Programme de traitement de message par lequel le client regoit des 
messages du courtier. Le programme de traitement utilise le type suivant : 
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Typedef bool (*mqisdp_msgHdlr_f) ( 
Ascii * Topic, 
Bool Retain, 
Bool Duplicate, 
mqisdp_qos_e QoS, 
Mqisdp_messageid msgid, 
U16 PayloadLength, 
U8 Payload [1] 

); 

Si le programme de traitement de message renvoie la valeur True la 
fcbhotheque supprime le parametre Payload. Sinon, le client doit prendre en 
charge la gestion de la charge utile. 

Le parametre mqisdp_messageid est deiini comme suit : 

Typedef u 16 mqisdp_messageid; 
Le parametre mqisdp_qos_e est defini comme suit : 
Typedef enum 

{ 

MQISDP_QOS_0, 
MQISDP_QOS_l, 
MQISDP_QOS_2, 
} mqisdp_qos_e 

c - Valeurs de retour 

MQISDP_OK : Succes 

MQISDP_ERR_Q_FULL : File d'attente des messages a destination de 

Textgrieur trop petite/saturee 
MQISDP.ER R ^LR EADY _ CONNECrED . ^ 4 un 

Commencez par deconnecter. 
MQISDP_ERR_DISCONNECT_PENDING 

//Une deconnexion est en suspens. Attente de 
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la de*connexion. 

MQISDP_ERR_PARAM_CLIENT_ID : Le parametre client_id est illegal. 
MQIS DP_ERR_P ARAM_CLIENT_ID_T 00_B IG : Le parametre 

client_id est trop long (maximum 23 

caracteres). 

MQISDP_ERR_PARAM_TOPIC : Le parametre topic est illegal. 
MQISDP_ERR_PARAM_TOPIC_TOO_BIG : Le parametre topic est trop 

long (maximum 32 767 caracteres). 
MQISDP_ERR_PARAM_DATA_LENGTH : Le parametre 

payloadjength est illegal. 
MQISDP_ERR_PARAM_DATA_TOO_BIG : Le parametre payload est 

trop long (maximum 65 535 caracteres, y 

compris les en-t6tes). 
MQISDP_ERR_PARAM_QOS : Le parametre qos est incorrect. 
MQISDP_PIN_NOT_ENTERED : Une erreur du a un code PIN manquant 

s'est produite. 
3.6.5 Fonction mqisdp_disconnect 

Cette fonction est utilise pour fermer la connexion mqisdp. Si elle est 
appelee alors qu'une autre deconnexion est en suspens, une erreur est renvoyee. 
a - Prototype 

u8 mqisdp_disconnect ( 
mqisdpjmessageid* Msgld, 
bool InimediateDisconnect 
>; 

b - Parametres 

* Msgid : 

En retour, conserve lid attribu6 au message de deconnexion. 

* ImmediateDisconnect : 

Cet indicateur determine si la ddconnexion doit 6tre immediatement forc^e 
(si I'indicateur a la valeur True (vrai)) ou si la deconnexion peut attendre que tous 
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les messages actuellement en file d'attente soient distributes (ou supprim6s). Si la 
deconnexion peut attendre, la bibliotheque n'accepte pas de nouveaux messages 
du courtier. 

c - Valeurs de retour 

MQISDPJ3K : Succes. 

MQISDP_ERR_DISCONNECT_PENDING : Une deconnexion est d6jk 

en suspens. 

3.6.6 Foncti on mqisdp publish 

Cette fonction est utilisge pour pubiier un message MQIsdp au courtier de 
message. Cette operation ne peut Stre effectu<5e que si une connexion est dejk 
active. 

a - Prototype 

u8 mqisdpjpublish ( 

mqisdp_messageld* Msgld, 

ascii * Topic, 

mq±sdp_qos_e Qos , 

bool Retain 

ul8 PayloadLength, 

u8 Payload [1] 

) 

b - Paramfetres 
* Msgid : 

En retour, conserve Tid attribue au message de deconnexion. 
c - Valeurs de retour 
MQISDPJ3K : Succes. 

MQISDP_ERR_CONNECTION_INVALID : La connexion au courtier 

n ! est pas pr6te. 

MQISDP_ER_Q_FULL : La file d'attente des messages a destination de 

l'ext6rieur est trop petite/satur£e. 
MQISDP_ERR_DISCONNECT_PENDING : Une deconnexion est en 
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suspens. Impossible d'accepter des 
messages. 

MQISDPJERR_PARAMJTOPIC : Le parametre topic est illegal. 
MQISDP3RR^PARAM_TOPIC.TOO^BIG : Le parametre topic est trop 
5 long (maximum 32 767 caracteres). 

MQISDP_ERR_PARAM_DATA_LENGTH : Le paramfetre 

payloadjength est illegal. 
MQISDP_ERRJPARAM_DATAJTOO_BIG : Le parametre payload est 

trop long (maximum 65 535 caracteres, y 
!0 compris les en-t6tes). 

MQISDP_ERR_PARAM_QOS : Le parametre qos est incorrect. 
3.6.7 - Fonction mqisdp subscribe 

Cette fonction est utilis^e pour envoyer un message d'abonnement au 
courtier de message. Cette operation ne peut etre effectuee que si une connexion 
15 est deja active. 

a - Prototype 

u8 mqisdp_subscribe 
{ 

mqisdp_messageld* Msgld, 
20 ul6 NoOf Subscriptions , 

mqisdp_subscriptionParams_t* 

SubscriptionArray 

} 

b - Parametres 
25 * Msgid : 

En retour, conserve Tid attribu6 au message de dgconnexion. 

* NoOfSubscriptions : 

Nombre d ? 616ments du parametre SubscriptionArray. 

* SubscriptionArray : 

30 Tableau d'616ments de la structure suivante : 
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* Typedef struct 
{ 

ascii * Topic, 
u8 QoS 
} 

mqisdp^subscriptionParamsj:; 
c - Valeurs de retour 
MQISDP.OK : Succfcs. 

MQISDP_ERR_CONNECTIONJNVALID : La connexion au courtier 

n'est pas prSte. 

MQISDP_ERR_Q_FULL : La file d'attente des messages a destination de 

l'extSrieur est trop petite/saturee. 

MQISDP_ERR_DISCONNECT_PENDING : //Une disconnexion est en 

suspens. Impossible d'accepter des 
messages. 

MQISDP_ERR_PARAMJTOPIC : Le paramStre topic est illegal. 
MQISDP^ERR^PARAM^TOPIC^TOO^BIG : Le parametre topic est trop 

long (maximum 32 767 caract&res). 
MQISDP_ERR_PARAM_QOS : Le parametre qos est incorrect. 
3.6.8 - Fonction mqisdp unsubscribe 

Cette fonction est utilis^e pour publier un message de dSsabonnement au 
courtier de message. Cette operation ne peut etre effectuSe que si une connexion 
est d€]k active. 

a - Prototyp e 

u8 mqisdp_unsubscribe 
{ 

mqisdp__messageld* Msgld, 

ul6 NoOf Unsubscriptions, 

ascii * UnsubscriptionTopicAray 

} 
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b - Parametres 

* Msgid : 

En retour, conserve Fid attribu6 au message de deconnexion. 

* NoOfUnsubscriptions : 

Nombre d'616ments du param&tre UnsubscriptionArray. 

* UnsubscriptionArray : 

Tableau des rubriques concernees par le dSsabonnement. 
c - Valeurs de retour 
MQISDP_OK : Succ£s. 

MQISDP_ERR_CONNECTION_INVALID : La connexion au courtier 

n'est pas pr6te. 

MQISDP_ERR__Q_FULL : La file d'attente des messages & destination de 

l'exterieur est trop petite/saturee. 

MQISDP_ERR_DISCONNECT_PENDING : //Une deconnexion est en 

suspens. Impossible d'accepter des 
messages. 

MQISDPJERRJPARAMJTOPIC : Le parametre topic est illegal. 
MQISDP_ERR^PARAM_TOPIC.T003IG : Le parametre topic est trop 

long (maximum 32 767 caracteres). 
3.6.9 - Fonct ion mqisdp getConStatux 

Cette fonction est utilisee pour demander le statut de la connexion. 
a - Prototype 

u8 mqisdp_getConStatus (); 
b - Parametres 

Aucun 
c - Valeurs de retour 

MQISDP_CONNECTING : Si une connexion est en cours d'Stablissement 

(pas encore prSte h accepter des 
messages). 

MQISDP_CONNECTED : Si une connexion est active (et pr6te a accepter 
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des messages). 

MQISDP_DISCONNECTED : Aucune connection n'est active. 
3.6 JO -Fonetion mgixdp g etMxeStatuM 

Cette fonetion est utilisee pour demander le statut d'un message donn€. 
a - Prototype 

u8 mqisdp_getMsgStatus (mqisdp_messageid* Msgld) ; 
b - Parametres 

L'identifiant (id) du message. 
c - Valeurs de retmir 

MQISDP_IN_QUEUE : Le message est dans la file d'attente a destination 

de l'exterieur (n'a pas encore 6t6 envoy<5). 

MQISDP_SENDING : Le message est maintenant en cours d'envoi (par 

TCP/IP). 

MQISDP_IN_PROGRESS : Le message a ete envoye" par TCP/IP mais 

aucun accuse de reception n'a encore 6t6 
re9u. 

MQISDP_NO_SUCH_MSG : Le message n'existe pas (plus). Soit il n'a 

jamais 6t6 envoye, soit il a 6t6 envoye" et 
recu (accuse de reception de la part du 
courtier). 

3.6.11 - Fon etion mqixdv setOueuc.Ri^ P 

Cette fonetion est utilisee pour deTmir la taille de la file d'attente. La taille 
de la file d'attente peut 8tre modifiee a tout moment, mais si la nouvelle taille est 
trop petite pour contenir les messages actuels, une erreur est renvoyee. 

a - Prototype 

u8 mqisdp_setQueueSize (ul6 QueueSize); 
b - Parametres 

QueueSize : Taille de la file d'attente en octets. 
c - Valeurs de retour 
MQISDP.OK : Succes. 
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MQISDP_ERR_Q_FULL : La taille de la file d'attente ne peut pas 8tre 

dgfinie. Le param&tre est sans doute trop 
petit pour les messages actuellement en 
file d'attente. 

3.6.12 Fonction mqisdp get QueueSize 

Cette fonction est utilisee pour connaitre la taille actuelle de la file 
d'attente. 

a - Prototype 

ul6 mqisdp_get QueueSize (); 
b - Parametres 
Aucun. 

c - Valeurs de retouj- 

La taille actuelle de la file d'attente est renvoyee (en octets). 

3.6.13 - Foncti on mqisdp vetAvailableSire 

Cette fonction est utilisee pour connaitre la quantity d'espace disponible 
dans la file d'attente. 
a - Prototype 

ul6 mqisdp_getAvailableSize (); 
b - Parametres 

Aucun. 

c -Valeurs de retour 

L'espace actuellement disponible dans la file d'attente est renvoyd (en 

octets). 

3J_ Exemvle de mise en ceuvre 

La figure 3 presente un exemple d'envoi de message, h l'aide des fonction 
API de I'invention. 

Les etapes sont les suivantes : 

- initialisation 31 : fonction « mqisdp _init() ; 

- param&rage 32 de la dimension de la file d'attente : fonction 
mqisdp_setqueuesize () ; 
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- connexion TCP/IP 33 (ouverture (Tune session GPRS) ; 

- si la connexion n'est pas bonne (34) : message d'erreur 35 ; 

- sinon : connexion 36 au « courtier » : fonction mqisdp__connect () ; 

- si la connexion n'est pas bonne (37) : message d'erreur 35 ; 

- sinon : envoi du message 38 : fonction mqisdp_publish() ; 

- si ddconnexion 39, alors fin 310 ; 

- sinon message d'erreur 35. 



WO 2004/114624 



32 



PCT/FR2004/001498 



REVENDICATIONS 

1. Systeme de controle d'equipements a distance, permettant 1' interconnexion 
entre au moins un serveur et au moins un equipement distant selon le protocole 
MQIsdp, 

caracterise en ce qu'il associe a au moins un desdits equipements distants des 
moyens de radiocommunication capable de traiter en interne un protocole de 
communication mettant en oeuvre des fonctions source de type API disponibles 
dans une plateforme logicielle (Open AT) permettant d'embarquer au moins une 
application, 

et en ce que lesdits moyens de radiocommunication sont dot6s d'un jeu de 
fonctions (API) specifiques permettant d'echanger des donnees avec au moins un 
serveur mettant en ceuvre ledit protocole MQIsdp, 

de facon a permettre une interconnexion entre le ou lesdits serveurs et le ou lesdits 
equipements distants via lesdits moyens de radiocommunication, ces derniers 
gerant egalement au moins une application entre le ou lesdits serveurs et le ou 
lesdits equipements distants. 

2. Systeme de contrdle d'equipements a distance selon la revendication 1, 
caracterisS en ce que lesdits moyens de radiocommunication comprennent un 
module de radiocommunication, regroupant sur un m8me substrat 1'ensemble des 
moyens de traitement de donnees radio-frequence et bande de base, ainsi que les 
moyens de gestion desdites fonctions (API) et la ou lesdites applications. 

3. Systeme de contrdle d'6quipements a distance selon l'une quelconque des 
revendications 1 et 2, caracterisS en ce que lesdits moyens de radiocommunication 
integrent ledit protocole MQIsdp sous la forme d'une librairie, definissant ledit 
jeu de fonctions (API) specifiques. 

4. Syst&me de contr61e d'equipements a distance selon l'une quelconque des 
revendications 1 a 3, caracterise en ce que, au moins dans un premier mode, 
lesdits moyens de radiocommunication gerent uniquement la signalisation d'un 



WO 2004/114624 



33 



PCT/FR2004/001498 



^change de donn<Ses, lesdites donn^es etant transferees directement d'un 
equipement distant vers un serveur, ou inversement. 

5. Systeme de contr61e d'equipements k distance selon Tune quelconque des 
revendications 1 & 4, caracterise en ce que, au moins dans un second mode, lesdits 

5 moyens de radiocommunication gerent la signalisation d'un ^change de donnges 

et le transfert desdites donnees, ces dernteres etant temporairement stockees dans 
au moins une m6moire tampon. 

6. Syst&me de controle d'equipements k distance selon la revendication 5, 
caracterise en ce que la taille de la ou desdites mgmoires tampon est param6trable. 

10 7 - Systeme de controle d'equipements k distance selon les revendications 4 et 

6, caracterise en ce qu'il fonctionne dans ledit premier mode lorsque la taille de la 
ou desdites m<5moires tampon vaut 0, et dans ledit second mode sinon. 
8. Systeme de contr61e d'equipements k distance selon Tune quelconque des 
revendications 1 k 7, caracterise en ce que ledit jeu de fonctions API specifiques 

15 comprend des fonctions permettant : 

- la connexion a un desdits serveurs ; 

- Tenvoi de messages ; 

- la reception de messages ; 

- configuration d'au moins un param&tre. 

20 9 - Systeme de contrdle d'equipements k distance selon 1'une quelconque des 

revendications 1 a 8, caracterise en ce qu'au moins certaines desdites fonctions 
(API) specifiques sont organisees de fa9on k pouvoir assurer au moins deux 
operations et/ou agir sur au moins deux aspects distincts, en fonction d'un 
parametrage predefini. 

25 Systeme de contr61e d'equipements a distance selon Tune quelconque des 

revendications 1 & 9, caracterise en ce que ledit jeu de fonctions (API) comprend 
uniquement 12 fonctions. 

11. Systeme de contr61e d'equipements k distance selon Tune quelconque des 
revendications 1 k 10, caracterise en ce que ledit jeu de fonctions (API) 
30 specifiques comprend une fonction d'initialisation (mqisdpjnit) retablissant des 
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parametres par defaut, et devant Stre appelee au moins une fois avant 1'utiiisation 
d'autres fonctions (API). 

12. Systeme de contrdle d'equipements a distance selon l'une quelconque des 
revendications 1 a 11, caractense" en ce que ledit jeu de fonctions (API) 
specifiques comprend une fonction (mqisdp_resume) appelee lorsque une liaison 
IPa6teetablie. 

13. Systeme de contrdle d'equipements a distance selon l'une quelconque des 
revendications 1 a 12, caract6ris6 en ce qu'il comprend une fonction 
d'&ablissement d'une connexion avec un desdits serveurs (mqisdp_connect), 
permettant de deTmir des parametres de ladite connexion, et une fonction de 
deconnexion (mqisdp_disconnect) de ladite connexion. 

14. Systeme de contrdle d'equipements a distance selon la revendication 13, 
caracterise en ce que ladite fonction d'etablissement d'une connexion permet de 
selectionner un mode de transmission parmi au moins deux (GSM et GPRS). 

15 15. Systeme de contrdle d'equipements a distance selon l'une quelconque des 

revendications 1 a 14, caractens6 en ce qu'il comprend une fonction 
(mqisdp_publish) pour I'envoi d'un message vers un desdits serveurs. 

16. Systeme de contrdle d'equipements a distance selon l'une quelconque des 
revendications 1 a 15, caractense en ce qu'il comprend une fonction 
d'abonnement a un desdits serveurs (mqisdp_subscribe), et une fonction de 
desabonnement (mqisdp_unsubscribe) audit serveur. 

17. Systeme de contrdle d'equipements a distance selon l'une quelconque des 
revendications 1 a 16, caracterise en ce qu'il comprend au moins une fonction de 
demande d'information sur au moins un aspect d'une communication en cours. 

25 18. Systeme de contrdle d'equipements a distance selon la revendication 17, 

caracterise- en ce qu'il comprend au moins une des fonctions appartenant au 
groupe comprenant : 

- une fonction de demande du statut d'une connexion 
(mqisdp_getConStatus) ; 

- une fonction de demande du statut d'un message donn€ 
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(mqisdp_getMsgStatus) ; 

- une fonction de demande de la taille actuelle d'une file d'attente 
(mqisdp_getQueueSize) ; 

- une fonction de demande de l'espace disponible dans une file 
d'attente(mqisdp_getAvailableSize). 

19. Systeme de contrdle d'6quipements a distance selon l'une quelconque des 
revendications 1 a 18, caracterise" en ce qu'il comprend une fonction de definition 
de la taille d'une file d'attente (mqisdp_setQueueSize). 

20. Proc6de de contrdle d'equipements a distance, permettant l'interconnexion 
entre au moins un serveur et au moins un equipement distant selon le protocole 
MQIsdp, 

caracteris6 en ce qu'il associe a au moins un desdits equipements distants des 
moyens de radiocommunication capable de traiter en interne un protocole de 
communication mettant en oeuvre des fonctions source de type API disponibles 
dans une plateforme logicielle (Open AT) permettant d'embarquer au moins une 
application, 

et en ce qu'il met en oeuvre, dans lesdits moyens de radiocommunication, un jeu 
de fonctions API specifiques permettant d'echanger des donnees avec au moins 
un serveur mettant en ceuvre ledit protocole MQIsdp, 

de faeon a permettre une interconnexion entre le ou lesdits serveurs et le ou lesdits 
equipements distants via lesdits moyens de radiocommunication, ces derniers 
gerant egaleinent au moins une application entre le ou lesdits serveurs et le ou 
lesdits equipements distants. 

21. Dispositif de radiocommunication caracterise en ce qu'il comprend des 
moyens de radiocommunication mis en ceuvre dans un systeme de contrdle 
d'equipements a distance selon l'une quelconque des revendications 1 a 19. 

22. Module de radiocommunication caracterise en ce qu'il comprend des 
moyens de radiocommunication mis en ceuvre dans un systeme de contrdle 
d'equipements a distance selon l'une quelconque des revendications 1 a 19. 

23. Jeu de fonctions (API) mis en oeuvre dans un systeme de contrdle 
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d'equipements a distance, caracteris6 en ce qu'il permet d'6changer des donnSes 
avec au moins un serveur mettant en ceuvre ledit protocole MQIsdp. 



WO 2004/114624 



PCT7FR2004/001498 



2/3 




Fig. 2 
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Initialisation 
mqlsdp-lnitQ 
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Parametrage 
file d'attente 
Mqlsdp-SetQueueSizeQ 
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Connexion TCP/IP 
( ouverture de 
session GPRS ) 
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Connexion au broker 
Mqlsdp-ConnectQ 
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Envoi du message 
Mqlsdp-PublishQ 
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